home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / music / fb01.arc / fb_patch.doc next >
Text File  |  1992-03-02  |  7KB  |  170 lines
  1.                ---------------------------------
  2.  
  3.  
  4.  
  5.                          ** FB-Patch **
  6.  
  7.                           Version 1.10
  8.  
  9.  
  10.  
  11.                    Distributed by:
  12.  
  13.                           Polk Products
  14.                           P.O. Box 36782
  15.                           Birmingham, AL 35236
  16.         
  17.  
  18.  
  19.  
  20.                ---------------------------------
  21.  
  22.     
  23.      FB-Patch is a voice and configuration editor/librarian for use with 
  24. the Atari ST and the Yamaha FB-01 FM Sound Generator. FB-Patch is written
  25. in compiled GFA Basic. Version 1.10 is being distributed as "optionware".
  26. Use it and/or distribute it at no cost. However, FB-Patch IS copyrighted.
  27. So, please remember to include this DOCument file AND the "READ ME" file
  28. anytime FB-Patch is distributed. Also, no charge should be made (other
  29. than the media cost and any shipping/handling costs) for providing this
  30. software.
  31.  
  32.      FB-Patch 2.00 will be available in early 1988 from Polk Products and
  33. will include many features not found in the current version (1.10). Refer
  34. to the accompanying "READ ME" file for details concerning the features
  35. and availability of FB-Patch 2.00. Write to Polk Products for information
  36. about FB-Patch 2.00 if the "READ ME" file is not available.
  37.  
  38.      The documentation that follows is NOT a complete guide to the use of
  39. FB-Patch. It DOES provide enough information to get you going. Complete
  40. documentation will be made available with FB-Patch 2.00.
  41.  
  42.  
  43.                ---------------------------------
  44.  
  45.  
  46.      The basic functions of FB-Patch (version 1.10) include:
  47.  
  48.          - Instrument (Voice) and Configuration transfer both to and from
  49.              the FB-01.
  50.  
  51.          - FB-01 Voice and Configuration editing, creating, saving to disk,
  52.              and retrieving from disk.
  53.  
  54.          - Optional "real-time" updating of FB-01 instrument as parameters
  55.              are updated.
  56.  
  57.          - Testing an FB-01 voice (instrument) using the mouse to vary pitch
  58.              and velocity.
  59.  
  60.  
  61.      The current version of FB-Patch performs all voice functions on an
  62. INSTRUMENT basis.  An instrument is one of the (up to) 8 active voices
  63. in an FB-01 configuration. 
  64.  
  65.      Before uploading instruments to the FB-01, set Protect OFF on the
  66. FB-01 (using "System Setup" button).
  67.  
  68.      To UPLOAD a voice to the FB-01, select "Send Instrument", then select
  69. an instrument number (ie 1 thru 8) to receive the voice. 
  70.  
  71.      *NOTE* Read your FB-01 manual for information on saving a voice after
  72. it has been uploaded from the ST (to one of the 8 instruments).
  73.  
  74.      To DOWNLOAD a voice from the FB-01, select "Receive Instrument",
  75. then select an instrument number to download. The voice that will be
  76. received is be the one stored as the selected instrument in the current
  77. FB-01 configuration.
  78.  
  79.      To activate the "SENDING PARMS" feature, you must select the instrument
  80. to which parameters are sent as they are changed. Be sure to turn on the
  81. feature ONLY when the voice to be edited on the screen corresponds exactly
  82. to the FB-01 receiving instrument's voice. Otherwise, there may be some
  83. differences between the screen parameters and the FB-01 parameters that
  84. remain until those specific parameters are changed on the screen.
  85.  
  86.      To EDIT a voice using FB-Patch, point to a parameter value with the
  87. mouse and use the right or left button to raise or lower the value. To
  88. change the voice's name, point to the name, double click the left button,
  89. enter the name, then press Return.
  90.  
  91.      To TEST an instrument, move the mouse to the voice test area on the 
  92. right of the ST screen. The MIDI note value and velocity will be displayed
  93. and can be adjusted by pointing the mouse elsewhere in the test area. 
  94. Play the note by pressing and holding either of the mouse buttons. Test
  95. notes are sent on the MIDI channel indicated in the test area. The channel
  96. used can be changed by clicking on "Select Test Channel". 
  97.  
  98.      It may sometimes be helpful to use the Alternate key, the Shift key,
  99. the Arrow keys, and the Insert key to perform the mouse functions after
  100. moving the cursor to the voice test area, as follows:
  101.  
  102.                   Alt + Arrow == Move Cursor
  103.                   Alt + Shift + Arrow == Move Cursor 1 Pixel
  104.                   Alt + Insert == Press Left Button
  105.  
  106.                          
  107.                ---------------------------------    
  108.  
  109.  
  110.      A TYPICAL SESSION with FB-Patch might occur as follows. 
  111.  
  112.      Start FB-Patch. Turn on FB-01. Select a user configuration and turn
  113. Protect OFF by using the System Setup button. Either (1) set an instrument
  114. to a desired voice and receive that instrument from the FB-01, OR (2) load
  115. a desired voice from disk and send that voice to an instrument in the 
  116. selected FB-01 configuration. The voice being edited and the selected
  117. instrument are now "in sync", so select "Send Parms".
  118.  
  119.      Begin editing the voice on the screen. As changes are made, try out the
  120. changes by testing a few notes from the test area. When the desired effect
  121. is achieved, save the voice to disk as a ".VOC" file. Be sure to change the
  122. voice name, if appropriate. 
  123.  
  124.      To save the voice as one of the FB-01's 96 user voices, first set one
  125. of the instruments to the desired bank/voice. Then send the voice to that
  126. instrument. To make the "change" permanent, push the "Voice Select" button
  127. to see "Voice/stor #". Push "Data Entry +1" followed by "Data Entry -1".
  128. Then push "Voice Select" again. Push "Data Entry +1/Yes" in response to
  129. "sure?" to save the voice.
  130.  
  131.      After establishing the voices to be used in a configuration, select
  132. "Edit Config." to switch to the configuration editing screen. Provide the
  133. necessary data for each instrument (including bank/voice#), OR load a
  134. previously saved configuration file from disk. Then send the configuration
  135. to one of the user configurations on the FB-01. Be sure to provide the
  136. proper configuration name on the screen. *NOTE* If you send a configuration
  137. to the user configuration that is currently selected on the FB-01, then 
  138. the new configuration data will not be displayed when it is sent.
  139.  
  140.      To save the configuration data for later access, save it to disk as a
  141. ".CFG" file.
  142.  
  143.  
  144.                ---------------------------------
  145.  
  146.  
  147.  
  148.  
  149.      Please report ANY problems you encounter to me via GEnie or one of the
  150. other BBS's listed below. Or write to me at:
  151.  
  152.  
  153.                       Polk Products
  154.                       ATTN: Harry Wootan
  155.                       P.O. Box 36782
  156.                       Birmingham, AL 35236
  157.  
  158.  
  159.  
  160.                  Harry Wootan -- Author/Developer
  161.  
  162.                       "H.WOOTAN"   on GEnie
  163.                       "72337,2336" on CompuServe
  164.                       "POLK"       on Delphi
  165.  
  166.  
  167. November 8, 1987
  168.  
  169. (FB-Patch copyright 1987 by Harry Wootan)
  170.